package org.example.flea_market_mvc.service.user;

import org.example.flea_market_mvc.entity.User;
import org.example.flea_market_mvc.param.LoginParam;
import org.example.flea_market_mvc.param.UserParam;

import java.util.List;

/**
 * 用户服务接口
 * 负责用户相关的业务逻辑处理，包括用户的增删改查、登录、注册等操作
 */
public interface UserService {

    /**
     * 插入新用户记录（注册）
     * @param userParam 用户参数对象，包含用户信息
     * @return 插入成功返回1，失败返回0
     */
    int insert(UserParam userParam);

    /**
     * 根据用户ID删除用户记录
     * @param id 用户ID
     * @return 删除成功返回1，失败返回0
     */
    int deleteById(Long id);

    /**
     * 更新用户记录
     * @param userParam 用户参数对象，包含更新后的用户信息
     * @return 更新成功返回1，失败返回0
     */
    int update(User userParam);

    /**
     * 根据用户ID查询用户记录
     * @param id 用户ID
     * @return 用户实体对象，未找到返回null
     */
    User selectById(Long id);


    /**
     * 查询所有用户记录
     * @return 用户实体列表
     */
    List<User> selectAll();

    /**
     * 用户登录
     * @param loginParam 登录参数对象，包含用户名和密码
     * @return 登录成功返回用户实体对象，失败返回null
     */
    User login(UserParam loginParam);
}